Determines the default attributes or behavior for dialog boxes.

OSErr NavGetDefaultDialogOptions (
    NavDialogOptions *dialogOptions
);

dialogOptions

A pointer to a structure of type NavDialogOptions. On return, Navigation Services fills out the structure with default option values that your application can change as needed.

function result

A result code.

DISCUSSION

This function gives you a simple way to initialize a structure of type NavDialogOptions and set the default dialog box options before calling one of the dialog box display functions. After you create the NavDialogOptions structure, you can supply it with the NavDialogOptions constants, described in “Dialog Option Configuration Constants”, to change the configuration options.

VERSION NOTES

Available in Navigation Services 1.0 and later.

AVAILABILITY

Supported in Carbon. Available in CarbonLib 1.0 and later when NavigationLib 1.0 or later is installed. Exported by CarbonLib 1.0 and later and by NavigationLib 1.0 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/17/2000)